[設定] 筆記側邊目錄設定

note

之前原本是將設定寫在筆記(Note)區的。將當初的內容整理到網站變更的文章中。

僅記錄調整的方法，如果需要看網站目前真實設定可以參考置頂區的目前全站設定檔案

Docusaurus的Docs有提供側邊欄生成的功能。其中這個側邊欄可以做一些調整，讓我們在閱讀文章及檢索文件的時候可以更方便。

將側邊欄（sidebar）設定為可縮至左側

將整個sidebar可以縮到左側，讓主要內容有更多顯示空間

docusaurus.config.js

const config = {
  themeConfig:
    /** @type {import('@docusaurus/preset-classic').ThemeConfig} */
    ({ tableOfContents: {
        minHeadingLevel: 2,
        maxHeadingLevel: 5,
      },
      docs: {
        sidebar: {
          hideable: true,
          autoCollapseCategories: true,
        },
      },
      ...
    }),
};
module.exports = config;

將側邊欄（sidebar）折疊其餘非當前路由

隨著內容的增多，有時候在尋找文檔的時候會打開許多的category 這時候可能會導致側邊欄變得很長，需要頻繁使用滾輪 將這個設定打開就可以只顯示我們目前所點選的category的內容（即便多層category也可以支援）

docusaurus.config.js

const config = {
  themeConfig:
    /** @type {import('@docusaurus/preset-classic').ThemeConfig} */
    ({ tableOfContents: {
        minHeadingLevel: 2,
        maxHeadingLevel: 5,
      },
      docs: {
        sidebar: {
          hideable: true,
          autoCollapseCategories: true,
        },
      },
      ...
    }),
};
module.exports = config;